home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / finance / bb-stock.1 < prev    next >
Text File  |  1996-11-16  |  7KB  |  205 lines
  1. BB STOCK TOOL Release 2.1 README 
  2.  
  3. Files
  4. =====
  5.     README -- information and installation
  6.     bb_doc.ps.gz -- bb document, user's guide in PostScript
  7.     order_form -- use this form to order BB Stock Tool license
  8.                   and/or historic stock quotes
  9.     stkdata.tar.gz -- sample up to date historic stock data
  10.  
  11.     bb_solaris.tar.gz -- for Sun/Solaris 2.X
  12.     bb_sunos.tar.gz -- for Sun/SunOS 4.X
  13.     bb_linux.tar.gz -- for PC/LINUX
  14.  
  15.     gunzip.sunos -- GNU unzip, for Solaris 2.X
  16.     gunzip.solaris -- GNU unzip, for SunOS 4.X
  17.     csco.gif -- snapshot of BB Stock Tool, use xv, xloadimage to view
  18.  
  19. NOTE: 
  20. a)  use gunzip to unzip .gz file, for example:
  21.     bb_doc.ps.gz is gzip compressed PostScript document
  22.     It has 45 pages, to print it on a Laser Printer:
  23.         gunzip bb_doc.ps
  24.         lpr bb_doc.ps
  25. b)  LINUX version is for libc-4.6 and XFree 3.1.1
  26.     To find gcc libc version, use "ls -l /lib/libc.so.4"
  27.  
  28. Installation
  29. ============
  30. To install in Solaris 2.X environment: You need to get
  31. bb_solaris.tar.gz, stkdata.tar.gz and gunzip.solaris.
  32.  
  33. The installation procedures for SunOS 4.X and LINUX are similar.  For
  34. SunOS 4.X, you need bb_sunos.tar.gz, stkdata.tar.gz and gunzip.sunos.
  35. For LINUX, you need bb_linux.tar.gz and stkdata.tar.gz. gunzip is a
  36. standard command on LINUX.
  37.  
  38. Assume using $HOME/stk2.1 as the BB Stock Tool's root directory
  39.     $ cd $HOME
  40.     $ mv gunzip.solaris gunzip
  41.     $ chmod +x gunzip
  42.     $ gunzip bb_solaris.tar.gz
  43.     $ tar xvf bb_solaris.tar
  44.     $ gunzip stkdata.tar.gz
  45.     $ tar xvf stkdata.tar
  46.     $ rm -f stk
  47.     $ ln -s stk2.1 stk
  48.     $ cd stk/etc
  49.     $ ./instkey
  50.     Please enter authorization code: [enter authorization code]*
  51.  
  52. * Please see the last section of this file for the authorization code.
  53.  
  54. Setup Environment
  55. =================
  56. BB Stock Tool needs an environment variable STOCK_HOME, which is the
  57. root directory of BB.  
  58.  
  59. The Sun SPARC version is based on X11R5.  If you don't have
  60. /usr/lib/X11/nls directory on your system, you need to setup an
  61. environment variable XNLSPATH to point to the nls directory, otherwise
  62. cut/paste and tearing off a menu may cause core dump.  we have
  63. included nls directory in our distribution, it is at
  64. stk2.1/lib/X11/nls.  If you are using LINUX, you don't need to set
  65. XNLSPATH environment variable.
  66.  
  67. o sh/ksh users
  68.     $ export STOCK_HOME
  69.     $ STOCK_HOME=$HOME/stk
  70.     $ export XNLSPATH
  71.     $ XNLSPATH=$STOCK_HOME/lib/X11/nls
  72.  
  73.     Put the following into $HOME/.profile
  74.     STOCK_HOME=$HOME/stk
  75.     export STOCK_HOME
  76.     export XNLSPATH
  77.     XNLSPATH=$STOCK_HOME/lib/X11/nls
  78.  
  79. o csh users:
  80.     % setenv STOCK_HOME $HOME/stk
  81.     % setenv XNLSPATH $STOCK_HOME/lib/X11/nls
  82.  
  83.     Put the following into $HOME/.login
  84.     setenv STOCK_HOME $HOME/stk
  85.     setenv XNLSPATH $STOCK_HOME/lib/X11/nls
  86.  
  87. To setup MANPATH
  88.     MANPATH=$MANPATH:$HOME/stk/man
  89.  
  90. You may want to setup PATH to include BB Stock Tool's commands
  91.     PATH=$PATH:$HOME/stk/bin
  92.  
  93. Migration from Previous Release
  94. ===============================
  95. To migrate to Rel 2.1 from previous release, say Rel 2.0, after you
  96. have completed the above installation procedure, do the following:
  97.  
  98.     $ cp ~/stk2.0/tic/_*_ ~/stk2.1/tic
  99.     $ cp ~/stk2.0/lib/.[a-z]* ~/stk2.1/lib
  100.     $ cp ~/stk2.0/etc/license.dat ~/stk2.1/etc
  101.     $ cp ~/stk2.0/TRADE.LOG ~/stk2.1
  102.  
  103. Ready to Run
  104. ============
  105. Run BB Stock Tool, set the background color as gray:
  106.     $ ~/stk/bin/bb 
  107.  
  108. To load a stock, simply click on either of the two leftmost icons
  109. which looks like a page with folded corner in the toolbar to load
  110. stocks, you can also type Control-N to load a stock.  For more
  111. information, please see the document.
  112.  
  113. NOTE:
  114. o If you get coredump when tearing off "Load Stock" pull right menu or
  115.   when you cut and paste on text field, you may not have "nls" directory
  116.   installed on your system.  This directory is a standard part of the
  117.   MIT X11R5 distribution, but is not included with OpenWindows 3.0 or
  118.   earlier.  BB Stock Tool Release 2.1 has bundled "nls" directory at
  119.   $STOCK_HOME/lib/X11/nls for Sun/SPARC version.  You can install it at
  120.   /usr/lib/X11/nls, or setup an environment variable XNLSPATH pointing
  121.   to $STOCK_HOME/lib/X11/nls.
  122.   
  123. o If you get error message "Unknown keysym name: osfRight", etc.
  124.   Try download XKeysymDB from ftp.portal.com.
  125.  
  126. o If you get a popup "license file not found".  It is most likely that
  127.   you did not install license file correctly.  See Installation section.
  128.  
  129. o If BB Tool could not start and gave error message:
  130.   Warning: Cannot allocate colormap entry for "Green3"
  131.   Warning: Cannot allocate colormap entry for "#b7c1e5"
  132.  
  133.   X Error of failed request:  BadDrawable (invalid Pixmap or Window parameter)
  134.   Major opcode of failed request:  14 (X_GetGeometry)
  135.   Resource id in failed request:  0x0
  136.   Serial number of failed request:  1009
  137.   Current serial number in output stream:  1009
  138.  
  139.   It is due to some other applications, such as Mosaic, netscape have
  140.   exhausted the colormap cells.  You may quit those applications and
  141.   BB Stock Tool can run properly.
  142.  
  143. If you experience other problem, please send e-mail to us at
  144. ctor@shell.portal.com.  Please provide us with:
  145.  
  146. >> Operating System version (the output of "uname -a")
  147. >> Window version: X11R4, X11R5, OpenWindows
  148. >> Output of "ldd $STOCK_HOME/bin/bb". 
  149.  
  150. It will help us to identify your problem.
  151.  
  152. Historic Quote
  153. ==============
  154. Evaluation package contains all the functionalities of a licensed
  155. version.  It comes with up-to-date historic stock quotes on five
  156. stocks (Apple, Bay Network, Cisco, IBM and Sun Microsyststems) and DJ
  157. Industrial average for your evaluation.
  158.  
  159. If you would like to evaluate other stocks on any US Stock Exchange,
  160. you may order them from Falkor Technologies at US$1.00 per stock.
  161. Each historic stock quote contains daily high, low, closing and volume
  162. for about two years.  Please use order form to order additional
  163. historic quotes.
  164.  
  165. Daily Quote
  166. ===========
  167. Falkor Technologies provides FREE BB Daily Quote Service to trial
  168. users and licensed users.  The quote is sent via e-mail at the end of
  169. each trading day.
  170.  
  171. You can register to receive BB daily quote via our web site or e-mail.
  172. Our web site is at http://www.portal.com/~ctor/bb.html.  To register
  173. via e-mail, simply send an e-mail to ctor@shell.portal.com with
  174. "Subject: Quote", and list your stock symbols in the mail, one symbol
  175. per line; the maximum is 200 stock symbols.  (Note: we do not carry
  176. mutual fund quotes).
  177.  
  178.     $ mail ctor@shell.portal.com
  179.     Subject: Quote
  180.     AAPL
  181.     BNET
  182.     CSCO
  183.     IBM
  184.     SUNW
  185.     <end_of_file>
  186.  
  187. When your BB daily quote arrives, you can save the email into a file.  
  188. To update your historic quote database, you may do it either from BB 
  189. Stock Tool or from command line.
  190.  
  191. 1. In BB Stock Tool, use "Edit => Update Historic Data...".
  192. 2. From command line, enter "fmttic t950807.dat t950808.dat"
  193.  
  194. The usage of fmttic is "fmttic <filenames>", fmttic accepts one or
  195. more files and it won't add any redundant record into the historic
  196. quote database.
  197.  
  198.     $ fmttic t1026.dat t1027.dat t1028.dat
  199.  or $ fmttic t*.dat
  200.  
  201. Authorization Code
  202. ==================
  203. Please get authorization code via our web page at:
  204. http://www.portal.com/~ctor/bb.html
  205.